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Original Issue - Software Release Level Mark 7.0. 


8.0 Release 


5-2 . If SPO is set to a value "n", the first 72 characters 
of "n"" lines of every message from the host will be 
displayed on the SPO. 
Added Program Switch #1, SPO dicots. 
Added Program Switch #7, HOT READER. 
Handler Notes: added. eeereqcs to line turnaround. 
Handler Section example for Terminal Section changed. 
&9-2 Added Section on HOT READERS. 
Message WAITING FOR MCS QUEUE NOT FULL new. 
Message NOT ALLOWED IN HOT READER MODE added. 
Message STREAM DECK MISSING and THE INPUT FILE IS A 
HOT READER AND. new. 
Heseeee <?END> CARD MISSING - EOF ASSUMED new. 
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| Changes for MARK 10.0 Release - 


2-1 Changed "(O-17)" t 0 "(0- 18)" in "RJE3780/HANDLER 
: AS FSA" ns _ 
| 2-3 Updated second paragraph. in "Message Transmission" sect. 
| 2-4 Updated "If the input begins..."' paragraph. | 
| 2-5 Updated "For any exception..." paragraph. 
Updated "If the ‘transparent’ bit..." paragraph. 
2-6 Added “LOSS OF DATA SET READY'' section. 
| 2-7 _ Updated "TEMPORARY TEXT DELAY - (TTD)" section. * a 
3-6 Deleted “loss of data set ready" from "Line Problem" sect. 
Added "Re-Establishing Connection" paragraph. | 
4=5 Updated ''RESET'' - TERMINAL RESET section. 
6-2 Changed "0" to "1" in "Program Switch #2". 
| 6-3 Added "Program Switch #8". 
| 9-1 Added "If RJE3780 is executed..." paragraph. 
| A-2 
A-5 
A-l 


Added "LINE BID ACCEPTED" handler message. 
Added "AUTO SIGN-ON IN PROGRESS" message. | 
1 Added Ce Mec REMOVED FROM LSN <INTEGER= 


: | message. 
| A-12, Added "LINE DISCONNECTED. IF NOT ACU,..." message. 
A-14 Added "PRIMARY FILE = ‘STREAM DECK',"' | 


"PRIMARY FILE FLUSHED: <FILE NAME>," 
"PRIMARY FILE IS <FILE NAME>" and _ 
a “PRIMARY FILE '<FILE NAME>' OPENED" messages. 
A-16 Added "SECONDARY FILE FLUSHED: <FILE NAME>," 
| "SECONDARY FILE IS <FILE NAME," 

"SECONDARY FILE "<FILE NAME>", 

"STREAM DECK MISSING PLEASE LOAD..." and > 
"STREAM DECK STILL MISSING. GOODBYE!" messages. 
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INTROOUCTION 


This product specification describes the RJES780 software package 
as implemented on the Surroughs 81000. RJE3780 allows a #1000 
system to act as a remote site (terminal) to a central host I8M 
computer - communicating over telephone lines usSiINg a 
binary-synchronous line discipline. Two systems with which it 
has actually been qualified are DOS/POWER and OS/JES2. 


RJE3780 allows the remote user to transmit querieS» programs» and 


data files to the central host for processing and-p upon 
completion, to receive the final print or punch output at the 
remote site. Any computing service available to a remote I3M 


3780 user is now available to a Burroughs 81000 user through the 
use of RJE3760. | 


RJE3789 PACKAGE 


The RJE3780 package consists of two related progrars: RJE3780 
and RJES3780/HANDLER. RJESTSO/HANOLER is a datacomm handler 
written in NOL. It handles all of the details of communicating 
via the binary~synchronous Line discipline. RJE3780 as an MCS 


written in SOL which handles att user interface. it is 


responsible for accepting and executing atl user commands. These 
include packing data for transmissions unpacking and printing Cor 


punching) data received» and any reconfiguration requested by the 


user Ci.se@e» transparent/non-transparent» compress/non=compress>» 
etce)e 7 | | | | 


To use the RJE3780 packages both RJE3780 and the NDL handler 


—Ct.ee.o RJEI7EO0/HANDLER) must be executing. Communication between 
the two programs is achieved through the remote file "RJE37B80Q". 


Users wishing to run other datacomm programs at the same time 
Ce .ge»s CANDE )» may write their own handters taitored to their 
specific needs using the REQUEST and CONTROL sections of the 
RJEZS7B80/HANDLER and any other REQUEST(Cs) and CONTROLCs) which 


they may need. 


The remainder of this document is divided into severat sections. _ 
The first section covers RJE3780/HANDLER. It contains both 


general information on the structure of the handlers and details 
of handling the Line discipline and the HANDLER“MCS interface. 

The second section covers RJZ3780. It contains both a general 
overview of RJE3780» and specifics concerning the user interface 


and the internal workings of the program. The third section 


covers the commands available to the user and their various 


effects when utilized. The fourth section is intended to aid the 
user in setting up and running RJE3780. It contains useful 
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information which does not conveniently fit into the other 
sections of this document. The remaining sections cover 
Operating Instructions» a Sample Handler Section and an Apoendix 
giving both Handler and RJE3780 Error. we mages 
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NAME | | NUMBER 
B1000 NOL Information Manual 1073715 
B1000 System Software Operational Guide 1068731 
$1000 DC/Audit PeSe2 2212 5471 
81000 Message Control System Interface PeSe 2212 S447 
81000 Supervisory MCS © | Peds. 2219 0482 


81000 NOL/Library | | — Pe de 2212 5215 
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RJES7B0/HANDLER is a datacomm handlers written in NOL» which 
manages the details of the obinary=synchronous Line discipline. 
Except for an occasional message on the SPN» RIJESTBO/SHANDLER is 
invisiote to the user. There is no user interfacere and all of. 
its interactions are either with RJE3780 Cthe MCS) or the 
datacomm lines. | 


RIES TBEYZHANDLER AS FSA 


RJES7TBO/HANDLER is actually a finite state automata (CFSA) where 
the $tates are defined by the finite (0°13) vatues of 
*LINECTALLY{£O1])*. In alt cases it 1S this value of 
"LINECTALLYCO])* which determines the portion of the code to be 
executed. The REQUEST section of the handler is an infinite loop 
With a CASE statement as its only element. The index into this 
CASE statement ts *LINECTALLYCO])* Cthe state). The handler can 
Loop through this CASE statement and» depending on the inputs. 
Ce.ge» Line bid» improper responser message queued» etce)J» may 
change its state froa one cycle to the next. The state can also 
te changed by going through the CONTROL (Cesge» time~up» message 
queuedr etc.) and having the value of "LINECTALLY£0])* changed 
there. 


an os <i TD E> AN Ra GE ON A eee OOO aan ee GD ES CE NER OE COS GR ORE 


As was mentioned earlier» the onty external interactions of 
RJES7GBO/HANDLER are either with the datacoam line CFfINISH 
TRANSMITs INITIATE RECEIVE) or with RJE3780. Communication with 
RJE37689 is accomplisned through a remote file with headers. 
Messages which are sent or received over the Line by the handier 
are passed through this file. In addition to these messages» 
some information is passed back and forth in the header. TOGE13 
through TOGL4] are used to pass data related information 
(transparent /non-transparents ETB/ETX» etc.). TALLY£LO] is the 
real work horser carrying line related information (Cline bid 
rejected/accepted» Line disconnected» RVI received» etce). 
_ Message Length» message type» station numbers etc.» are also 
passed in the header. The various values and purposes for the 
TALLY's and TOG's of the Line and of the station are Listed in 


the source for 2JE3730/HANDLER and will not be reiterated here. 


EXECUTION PATHS AND STATES 
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TWO STATIONS DEFINED ON ONE LINE 


OQne point which deserves note 1s the existence of .the two 
Stations defined on the one Line. The definitions of the two 
Stations are the same. Alt normal message transmission- and 
reception 1% handled by station number one (#1). Station nunber 
two (#2) is reserved for sending an EDT out of sequence (C(eagep 
during reception) or a OLE FOT Cline disconnect). This will 
happen as soon as the CONTROL ts entered and the aporopriate 
queued message is recognized. This atlows the line to be “turned 
around” or disconnected while input is in progress from the nost. 
The mechanics of this will be discussed later. 


To aid the user in understanding the workings of the coder» (or 


the programmer who must enhance or modify it)» the wvasic 
execution paths through the handler witl oe covered in detail. 
These include tine bid and message transmissions message 
receptions Line disconnects» reverse anterrupts CRVI)» and 


temporary text delays CTTD).~j While studying this section of the 
product specs the reader might find it heloful to have a source 
Listing of the handler present for perusal. A working knowledge 
of NOL as implemented on the B1000 will also be necessary if the 
reader wishes to take full advantage of this section. Alt 
acttons are assumed to be handled by station number one (13 
unless specifically stated otherwise. For the sake of these. 
discussi1onse “State n”™ will be synonymous with "*LINECTALLY(0])° 
with value n™ and a “message” will be composed of one or more. 
blocks of dataej The idte state of the handler is State 17. In 


this state the handler is waiting for a line bid from the host. 


This consists of a READ with no time-out and is completed either 
Dy a line bid from the host or a CANCEL tn the CONTROL Cie.» if 
a message is queued to be sent). —_ 
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Line 3id 


The line bid and message transmission sequence is perforsed every 

time the first block of a new message is queued to the handler — 
for transmission. Assuming a READ is in progress on the tine. 
(waiting for a line bid from the host)» the READ is cancelled in 


the CONTROL and State 9 is then entered. If there is no READ an 
the Lines» State 0 18 entered directly. State 0 initializes the 


retry count to the retry limit and continues to State 1. In 


State i» an ENQ is sent out on the Line with a timer Limit of one 


enS 
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second. If an ACKO 1s receiveds a “line tid accepted” message is 
queued for RJE3780 and State 2 is entered where the first block 
of data will be prepared for transmissions. If a NAK 18 received» 
a “Line bid rejected™ message is queued for RJE3780 and State 8 
is entered where control of the Line is relinquished by sending 

an £0T. If an £OT is received» State 13 18 entered where the 
handler clears its output queue and queues an informative message 
to RJE3730 before entering its original idle state (State 17). 
If a OLE EOT is received» State 14 is entered where the output 
Queue is cleared and an appropriate message is sent to RJE3780 


‘pefore disconnecting the tine. In the case of *"dial-out™ 


exceptions Cline busy» timeouts» etce)» the idle state is entered 
after an appropriate “Line bid rejected” message to RJE3730 and a 
clearing of the output queue. All other replies from the host 


CENQ» ACKI» timeout» parity» etc.) are treated by rewentering 


State ie decreasing the retry ‘count»s and repeating the ENQ@ 
transmission if the retry count has not been exhausted. If State. 
1 is ever entered with a retry count of 0» a “Line bid rejected" 
message is queued for RJE3780» the output queue is cleared» and 
the idle state ts entered after transmitting an E0T.. 


Message Transmission 


The most common case is where the tine bid is accepted with an 
ACKO. This is the input necessary to enable State 2. #£#In this 


State» a queued block of data ts prepared for transmission. if 


no block is queued» either State 8 1s entered to release control 
of the Line (if an EFTX was sent last or an RVI was received “from 


the host)» or State 6 is entered where a two~second wait is 


Initiated by entering the CONTROL. Assuming a block of data is 
present for transmission» at is preceded with STX CDLE STX if 


transparent) and followed with ETX or €T8 depending on whether or 


not it is the last block of a message (OLE ETX or DLE ETS if 
transparent). After that» State 3 18 entered where the actual 
transmission is initiated. In this state» the block of data is 
actuatly transmitted and a reply 1s awaited. 


{If the appropriate "ACK" is received» the block of the message 
which was sent is thrown away and State 2 1s re-entered to begin 


the transmission of another block. If the wrong ‘'ACK* is 
received» a WACK is received» or the handler times out» the 
message 1s written back to the station queue and State 4 15 


entered where an ENQ@ is prepared before returning to State 3 
again where it is actually transmitted. | Pi | a 


Tf an RVI is receiveds a message is queued for RJE3760 appraising 
ait of the fact and processing continues as though the appropriate 
"ACK® had been received. If a NAK 4S received» State 5 is 


-entered and the message block is rebuilt before returning to 


a 


en 
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State 3 for retransmisston. An STX Cor OLE STIX) received after 
having just sent the tlast block of a message turns the Line 
around. It is treated both as the correct *ACK* reply to the 


last btock sent and as though a tine bid from the host had 
already been approved and this was the first block of the 
message. Information is gqgteaned from the block of data 
Ctransparent/non-transparents text» ETB/ETX) and it is queued for 
RJE3789 along with the information that the line has heen 
turned-around and whether the text block is going to be ACKed or 


 NAKed. (TOGC4) is set if the text is to be ignored). State 11 


is then entered where the process of receiving messages from the 
host is handleg. 


MESSAGE RECEPTION 


Message reception is normally initiated from the idle state. 


When input is read by the handler in its idle state» State 10 is 
entered where the tnput is examined for meaningful content. If 
the input ts an ENQ> thens after a bit of housekeeping» State il 
is entered where the actual message reception is handled. If the 
wnput is a DLE EQTs» then State 14 ts entered where a “disconnect” 
message is queued for 2J&3780 and the handler awaits another tine 
connection. If the input is neither an ENQ nor a DLE ENT» then a 
message is written on the SPO and the idle state is re~entered to 
wait further action. 


If a proper Line bid is received Cand State 11 is entered)». the 


appropriate *ACKS is returned (Chaving been set in the 
housekeeping of State 10)» and the handler waits for “further 


input from the host. If the input begins with an STX Cor OLE 
S5TX) and ends with an ETB or ETX COLE ETB or OLE ETX)» the 
enclosed text 1s queued for the MCS with the necessary. 
information Ctransparent/non-transparent» ETd» ETX) and State il 
is re-entered to send the appropriate ‘ACK* and wait for further 
inpute 


If the input begins with STX Cor OLE STX) but ends with ENQ>» 
State 11 ts rewentered to send a  NAK to the host and await 
further input. If a OLE ENT is received» State 14 is entered 
where a message is queued to %JE3739 informing it of the 
“disconnect” before waiting for another Line connection. If an. 
ENT is received, State 13 is entered where an “end reception"* 
message 1s queued to RJE3780 and the idle state is entered to 


await further developments. For any line error other than loss 


of data set ready and timeout (narity» end of buffer» etceals 
State 11 is re-entered to send a NAK and await a response. For 
inputs tee than loss of data set ready (timeouts undecipherable 
input » etce)>» State 12 is entered where the handler waits for 


another response from the host. In this state» if an ENQ 43 
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received, State 11 is re~entered to send the "ACK* it sent tlast 
and to wait for more input. If an E€QT or OLE EDT is received in 


State 12,» either State 13 or State 14 is entered» respectively. 
(See action above). a 7 


For any exception other than timeout and loss of data set ready 
Cparity» etc.)» State 11 is re-entered to send a NAK and wait for 


further input. 


Message reception is ended at any time upon receiving an E01. 
State 13 18s entered» an “*end™ message queued for WJE3780» and the 
idle state is then entered where it waits further action. 


LINE DISCONNECT - RECEPTION 


Line disconnects operate in both directions. If» at any timer a 


DLE F£OT is received from the host» State 14 is entered» a 
"disconnect™ message queued for RJE3780» and the handler waits 
for another connection after clearing the output queue. 


LINE DISCONNECT = TRANSMISSION 

{If the user wishes to send a line disconnect (OLE ENT) or a cease 
function CENT)» a message must be queued to the. handler’ for 
Station #2. State 15 will be entered and the appropriate action 
taken. If input is in progress the message queued to station #2 
will be detected immediately upon the next entry into State 11 
and the handler wilt enter the CONTROL from where it wilt go to 
state 15. If the “transparent” bit CTOG£L2]) is set» 


1. DLE FOT will be sent> 


2. State 14 will be entered> 


36 A TOs conneiee” message will be queued for RJE3730> 
he The out put queue Will be cleared 
5. £=xThe hanaler will wait for another faae connection. 


If fie Senansearente bit is not set» EOT will be transmitted. 
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“LOSS OE DATA SET READY | 


If loss of data set ready occurs and the user is utilizing the 


autosign-on options the handler queues the “Rerestablish 
Connection” message to RJE3780»5 clears the output queue» anda 
waits for another connection. [f the auto sign-on is not used- 


the handler queues the “LINE DISCONNECT" message to RJE3780> 
clears the output queue» and waits for another connection. 


REVERSE INTERRUPT = CRI) 


At the oresent time» RJES7BAO/HANDLER is onty able to receive a 
reverse interrupt CRVI). It cannot send onew Upon receipt of an 
RVI during messaye transmissions an *interrupt”™ message is queued 


for RJE3738O0 and processing continues as though the proper "ACK® 
had been received» though note is taken that an RVI has been 


received CLINECTOG£3]) is set to 1). Spon recetving§ the 
“interrupt™ message from the handler» RJE3780 will ston queuing 
message blocks to RJE3780/HANDLER. When the handler finaitly runs 
out of message Dlocks to senda» it will note an RVI had been 
received and retease control of the line by sending an ENT Cin 


State 8). It will then wait for a Line bid from the host in the 


same manner as in the idle state. Upon receiving a line bid» it 
will clear the RVI tindicator CLINECTOG(3I)) and continue” the 
message processing normally.» It is the responsibility of RJE3780 
to restart transmission of the interrupted message by queuing 
blocks to the handler after receiving the message from the host. 
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A temporary text delay (TT0) is transmitted when the handler is 
in a message transmission mode» has not yet sent a block ended 


with ETX» and does not yet have the next ontock of the message to 


send after a two-second wait. This condition is initially 
detected in State 2 and causes the nandler to enter State 5. 
From here it enters the CONTROL where it waits for two seconds or 


until 4 message block is queued» whichever comes first. If a 


message block 1s queued» the handler returns to State 2 where it 


prepares the btock for transmission and continues processing in 


the normal messaye transmission mode.w If» on the other hand» no 
message block is queued after two seconds» the handler enters — 
State 7. If a message 15s Queued» State 2 18 entered for normal 
message transmission. Itherwise a TTD is sent to the host. If a 
NAK i¢ received (this is the proper response),r the handler 
returns to State 6 where it re-enters the CONTROL for another two 
second wait. If an ENT or a DLE EDT 15 received» State 13 or 
State 14 1s entered for function cessation CEODT) or tine 
disconnect (DLE EOT).~  %Loss of carrier or break results tn a 
message being queued to RJE37380. ALL other responses result in a 
message on the SPO and the handler returns to State 2 to make 
another attempt at finding a message block to send. 
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RSESL50 
RJE3780 provides the user interface in the system. It 1s an MCS 


written in SOL which accepts commands from the user via the SPQ 
and input from cards» taper or disk» and returns output oy way of 
the SP9- printer or cara punch. It is responsible for atl user 
communication and provides the interface Cor bridge) with the 
handler. All input iS prepared for transmission. (space 
compressions packing» etc.) and the resultant message blocks 
passed to the handler for actual transmission. Similarly» it 
accepts message blocks from the handler and outputs them on the 
appropriate device(s) after any necessary processing Cunpacking» 
space expansions etc.). | 


MAIN £90P = WATT STATEMENT 


RJE3730 is an infinite loop within which individual actions are 
driven Cor initiated) oy events in a comolex WAIT statement which 


forms the core of the loop. By enabling or disabling various 
events in the WAIT» many possible execution paths are enabled or 
disabled. These events in the WAIT statement will be discussed 


in the following sections» as well as some of the major execution 
paths through RJE3730 (send» receives reset» etce). AS presently 
configured» the WAIT statement has seven possible event triggers. 


liner Event 


The first of these events» and the last in line to be checked» 15s 
the timer. This is never disabled and is triggered every thirty 
(30) seconds if there is no other activity in the WAIT. It is 
reset every time some other event inthe WAIT ts activated. 
Depending upon the state of the system» disconnect procedures may 
be initiated upon the expiration of the timer. 


SPO Event 
The presence of input from the user (5PQ) is the first element of 
the event list to be checked for possible truth. As with the 


timers this event is always enabled. 


It is the first path chosen for processing on any swing through 
the main program Loop and all user commands are initiated in this. 


Way These user inputs are either commands (which will he 
discussed in a later section) or data for transmission to the 
host. This allows the user to transmit a one (1) record message 


Cif the line is not otherwise occupied). 
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Q (Remote File) Read Event 


The next check made tn the event list is for the presence of 


Input from the remote file CQFILE). Should this be the case» the 
input will be read and the appropriate action taken depending 
upon information contatned tn the header (1.2.-» TALLYCO)). This 
event is usually enabled except for those periods when a message 
block is being unpacked and printed Cor punched). The execution 
paths possible for this event wtil be discussed Later. 


Q (Remote File) Write Event 


The next element in the event list is for writing to the -remote 
file CQFILE). | This event is usually disabled except for those 


times when a message block is ready for transmission. If this ts 


the cases the event 18 enabled» andre when the event path is 


executeds the block 1s written and the event disabled again. 


- (Punch/Print)-Unpack Event 


The next two separate events in the List are for output from the 
host. If there is material to be punched Cor printed)» the 
appropriate event is enabled» and» when that path is taken» the 
data 1s punched (printed) and unpacking continued. These events 
are only enaoled when there is something to - punch (Cprint) and 
unpacks and are disabled otherwise. Againe the details of this 
path are covered later in this document. | 


Read=Pack Event 


This is the last event in the list Calthough it is checked just 
prior to the timer). It 1s enabled when the system 315 prepared 
to read and pack arecord of a message. It is disabled at allt 
other times. When this path is taken» a record is read from the 
appropriate device Cdetermined earlier via a user command)» the 
record. is compressed according to whatever option the user has 
specified earlier» and the compressed record is added to the 


output buffer. If there is no room for the record in the buffers 


this event is disabled» the remote file write is enabled» andr 
when the buffer has finally heen written to the remote file 
CQFILE)» this event is then enabled for further processing. 
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Remote File Read 


There are currently eleven (11) possible inputs that can be read 


from the remote file COFILE) which prompt action from RJE3789.. 
These witl be Listed and discussed including the effects they 
have on RJE3780. , | 


ALL buffers read from the remote file are expected to have a 
header. After reading the buffers the ‘"TYPE® field of the header 
is checked: to determine whether or not the buffer is a data 


puffer. If not» the buffer is discarded and the main Looping of 


RJE3789 continues. [f the ouffer is a data message» then the 


*"TALLYCO)* in the header is checked to determine which of the 
eleven possible courses of action to take. — 


Line Bid Rejected 
CTALLY(CO) = 0] 
If. a tine bid is attempted Cby queuing an initial message block 


to the handler) and is rejected for any reason» a “line bid 
rejected” message will be returned to RJE3780. This ts a null 


message (no datas just a header) with TALLYCO) = 0. The effect 


will 5e to inform the user that the line bid was rejected and it. 
gives the user the option of either. attempting another tine bid 


sequence or returning the system to a normal state for further 


processing. 


Line Bad Accepted 
CTALLYCO) = 123 


If a line bid is attempted (by queuing an initial message block 
to the handler) and is accepteds a “Line bid accepted” message is 
returned to RJE3780. This is a null message (no data»e just ae 
header) with YALLYC9O) = 1. This enables READ=“PACK event in the 
complex WAIT statement allowing RJE37380 to continue readings. 
packing» and transmitting the data file. If the first btock of 
the message is also the Last block» the system will be reset to a 

normal state. | - - 3 | 
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Reyerse Interrupt - (RYID 


CTALLYC)) = 2] 


If the handler receives a reverse interrupt CRVI) from the host» 
It sends a null message (no data» just a neader) to RJE3789. 
Upon reading this messages RJE3780 sets a flag that inhibits any 
further transmission of message blocks Calthough reading and 
packing may continue until the output buffer is full). This same 
flag 1s also used to automatically restart the transmission of 
further message blocks after receiving an "E0T* from the host». 
providing the appropriate option ts set. 


Cease Eunction - Iransmit/Receive 


CTALLYC9) = 3). 


The "cease function” message from the handler is used to informa 
RJE37B89 that the nandler has received an "EQT* from the host 
either during transmission or receotion. This is a null message 
(no datas just a header) with TALLY(0) = 3. If the *ENT* is 
received during a Line bid sequences the user has the option of. 
rebidding or not. if received during message transmissions the 
transmission is terminated and the system returns to a quiescent 
state. | | | 


If the ‘E0T* is received from the host during receptions it 
indicates the end of the message. In this cases any transmission 
previously tnterrupted by an "RVI can be restarted automatically 
or nots depending upon the options which have been selected. 


Line Turnaround 


LTALLYCO) = 43 


The "line turnaround” message indicates to RJE3780 that the host. 
has taken control of the line. This is accomplished by 
responding to the Last block of a message Cending with ‘'ETX?*) 
with a message block (Cbheginning with ‘*"*STX"') rather than the 
appropriate "ACK*. This avoids giving up control of the Line 
C"ENT*) and letting the host bid for control. | | 
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This message. nay or may not contain viable data. If TOGC4) in 
the header is set» the data contained in the buffer is in error 
and will not be processed. Dtherwises further reading from the 


remote file is suspended Cby disabling the event in the complex. 
WAIT statement) and unpacking and punching/printing of the data 
is begun. Reading from the remote file will again be enabled 
after all data in the current buffer is processed. 


Line Disconnect | 


CTALLYC 9) = 5) 


The “Line disconnect* message is a null message (no data» just a 

header) which indicates to  RJE3780 that the line has hecome 
disconnected. This is usually a result of receiving a "DLE EQT® 
from the host» or having sent one to the host. In either caser 
the user is informed of the fact and the system returns to a 
state waiting for the line to be connected again. If a tine bid 


1S an progresses the system will be prepared to retry the tine 
bide should the user $0 desiree. | 


Read Mode 


CTALLY(9) = 6) 


The "read mode™ message is a non=null message from the host 
containing output data to be processed by RJE3780. The effect of 
this message is to temporarily disable further reading from the 
remote file (via the complex WAIT) and initiate unpacking and 
punching/printing of the buffer. When processing of the buffer 
is completed (Catt records punched or printed)» the remote file 
read is again enabled for further message processing. 


*EQT® Sent. 


CTALLYCO) = 7) 


This message is an indication to RJE3780 that the handler has 
sent an "EOT® to the host.~j It ts a null message (no data» just a 
header) with TALLY(CO) = 7. At the present time» this is purely 
cosmetic. While the handler will send this message to RJE378G 


upon completing a message transmission» it currently has no 


effect upon the State of the Systeme 
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CTALLYCO) = 82 


The “line problem" message is a general purpose message which is 
used to inform the user that there is some problem on the _ Line. 
it is a mull message (no data» just a header) with TALLYCO) = 8. 
It contains no information avout the nature of the problem 
encountered» but serves merely to inform the user that a problem 
has been detected. Some problems which might be encountered are 
break and toss of carrier. | | 


CTALLYCO) = 9] 


The “Line connected" message is a null message (no datas just a 
header) with TALLYCO) = 9. It serves to inform RJE3780 that a 
connection has been establisheds either at system initialization 
or when the Line is re-connected following a prior disconnection. 
for any reason. | ES | 


Host Bid 


CTALLYCO) = 10]. 


The “host bid” message is a null message (no datas just a header) 
with TALLY(N) = 10. It serves to inform RJE3780 that the host 
has bid for and receivea control of the line and witl be sending 
a message presently. [It locks out any attempt to start a message 


transmission by RJE37380 and initializes the system to a “receive 


ready" state. 
Re-~Establishing Connection 


CTALLYC 3) = 11) 


‘The "Re-establish Connection" message is a null message (no datape 


just a header). This message is sent if the user has set the 
auto sign“on option. This message invokes the “Re-establish 
Connection” procedure. ; | 7 
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TRANSMIT/RECEIVE 


Two of the major execution paths possible in RJE3780 are sending 
a message to the host and receiving a message from tne host. 
Since these are the bastc tasks for which RJE3780 was devised» 


they will be covered in some detail. The transmission sequence 
will be covered first from inception to completion. After this»e 
the reception sequence wilt be discussedj For the purposes of 


these discussionse it will be assumed tnat the message (file) to. 
be transmitted is contained on some external storage mediua 
Ceega» cards» taper or disk). The sequence followed when 
transmitting a message from the SPO is essentiaily the same = and 
should he easy enough to follow tn the code» given the following 
discussione ; 


Initiate Iransmit 


The transmission sequence is initiated by a *.5D*>» TLR. or 


".5T* command to RJES780» depending upon whether the file to be 
sent is on disk» cards» or tape. (See the appropriate Listing 
under COMMANDS for acomplete description of the exact form of 


the command). Assuming the system 18 not otherwise occupied> the | 


transmission sequence is started. The first step is to determine 
the name of the file to be sent and to OPEN the file INPUT. If 
the file is not present on the specified device» the command is 
ignored and no transmission is attempted. If the file does exist 
on the designated device» various system flags are initialized 
and the READ~PACK event in the complex WAIT is enabled. 


A record is read from the tnput file. It is passed to COMPRESS 
where it is compressed according ta preset system parameters 
Cblank compresston or note transparent vS-e  non=transparent ». 
etce) and the result returned in the same buffer CCARD_BUFF) in 
which it was passed. _ 


The number of meaningful characters in the (now compressed) 


t 
buffer will be contained tn REC_SIZE. ‘lf there is room in the 
output buffer for the compressed = records it is included = and 


further reading and packing continue. If there is no more sdace 


in the output buffer» further reading from the input file 1s 


halted by disabling the event in the complex WAIT and steps are 
taken to tnitiate transmission of the output buffer. Similarly » 


if there are no more records to be read from the input file» — 
further reading from the input file is halted» and steps taken to 


Soa ae 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP : B1090 RJE3789 
SANTA 3ARBARA PLANT | Pede 2219 O391 REV C 


send the message block. 


Line Bid 


When the first block of the message is completed Coutput buffer 
fullds» the READ-PACK event tn the complex WAIT ts disabled = and 


the remote file WRITE event its enabled. When the event comes 
true» the buffer ts written to the remote file Cthis starts the 
line bid in the handler) and further writing is disabled. The 


output buffer is not discarded» and» since no further reading and 
packing 1s taking places the information in the buffer remains 
viable. | | | 3 


If the Line bid is accepted by the host» further reading and 
packing Cand sending) will be enabled via the complex WAIT. If 
the Line bid is rejected for any reasons the user is given. the 
option of trying again or cancelling the attempt. The line bia 
may be rejected because of exceeding the retry Limits» or it may. 
be due to a Line bid from the host being accepted before the 
handler received the buffer to send. Should the user decide to 
retry a rejected Line bid» he enters ".REBID'. Since the buffer 
is still around with the necessary informations the remote file 
WRITE event can be enabled in the complex WAIT ands when 
triggered» the output buffer written to the handler to try 
bidding again. If further Line bid attempts are cancelled (via 
*.CANCEL®)» various flags and parameters which indicate that a 
file is being sent are cleared and the system is returned to a. 
normal state. >? . | 3 


Final glock 


If» while filling a message block» the end of the input file is 
encountered» the buffer is marked as the Last block of the 

message (°TNG(1)" is set TRUE)» further reading is disabled» and 
the remote file READ 1s enabled via the complex WAIT. (This Last 
message block might also be the first block of the message). 
After writing this buffer to the remote file> the system 
parameters are reset to a normal state and the system is ready 
for any further pepcena ead. 
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Message Reception 


- Message ‘reception from the host is initiated as soon as the Line 
bid is accepted by the handler. If> after accepting the ‘ENQ®* 
from the host» the handler notices that a buffer has been queued 
by RJE3780 (for atline bid)» it. rejects the line bid attempt by 
RJE3730 and sends another message indicating that a line bid has 
been accepted from the host. This causes RJE3780 to initialize 
_various system parameters in DEC RAPOt Nol for receiving input from 
ene host. , | 


Yopack 


We will assume that the message being ere from the host is 
to be printed on the line printer. Punch data is handled in an 
analogous fashion and it should be easy enough to decipher. the 
punch paths given the following discussion of print paths. | 


Upon getting a buffer from the handler for unpacking» RJE3730 
bars any further reception from the handler (Cvia the complex 
WAIT) until the buffer has been completely processed.j Control i5 
then passed to UNPACK where various checks are made on the state 


of the "unpack". If the system is in the middle ef unpacking a 
records control is returned to the appropriate procedure for. 
further unpacking. If there is nothing left in the buffer for 


unpacking» printing Cpunching) is disabled in the complex WAIT 
and further reading from the remote file for a new buffer is 
enabled. If the buffer ts transparent data» unpacking is handied 
immediately and printing Cpunching) enabled. If the buffer being 
processed is the first block in a message Ci-ew» the Last buffer | 
was the tast block of a message)» then some system flags and 
parameters are initialized and a check made for a device 
selection character (since this is the only point in the message 
where it could be contained). Finally» af there 18s data to be 
unpacked» the appropriate expansion routine is called 
CEXPAND_PRINT_RECORD) after which output 18s enabled on the. 
associated device (printer). | = 


Expand Record 


Expansion of a punch record is relatively simple since there are 
no punch control characters to be sensitive to. In the case of a 
print cecord» there are various printer control characters which 
must be processed along with the print record. If no record is 
currently in the process of being unpacked» then the next recard 


to be unpacked is put in RCRD» parameters are initialized», and 


the actual expansion is started. This takes the form of a loop 
where the routine is scanning the record for various delimiters 
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and filling the print buffer with the print data it takes from 
the record being unnacked. Various flags and variables are used 
to hold the subsidiary information concerning printer controls 
and spacinge The record is tn the process of. betng unpacked 
until either the end of the record is reached Con the scan)se or 
until there is a problem with one of the scan delimiters. Upon 
leaving thts routiner control eventually passes to an output 
procedure CPRINT_AND_UNPACK). The | expansion routine 
CEXPAND_PRINT_RECORD) is quit upon finding some delimiter which 
requires immediate action. This could be one of various printer 
control characters» or could be an "IRS" which signals the end of 
the packed record. fhe unpacking of the record could still be in. 
progress even though the routine is Left to handle some printer 
control character. In such a cases control will eventually be 
returned to continue unpacking the record. 


Print (Punch) Record 


Upon leaving the record expansion routine CEXPAND_PRINT_RECORD)> 
control is returned to the UNPACK. From here» the appropriate 
output event in the complex WAIT is enabled and» when the event 
comes trues the control passes to the proper routine 
CPRINT_AND_UNPACK). In this routines the communicate is buiit 
and the output performed. {In the case of triple spacing on the 
printer » the routine is entered a second time to complete the 
necessary spacing before returning to UNPACK for further 
processing. | | | 


Intercuot/Disconnect 


RJE3780 gives the user the ability to send an "E0QT* (cease 
function) or a ‘OLE £0T* Cdisconnect) to the host. Although not 
designed to send an *RVI"%s a similar function can be performed by 
sending an "E0T*. This wilt cause the host to cease its 


transmission and release control of the line» at which time 


RJE3789 can initiate a Line bid for control. The ‘EQT® 
transmission sequence is initiated by giving RJE3760 the command 
"RVI" or ".INT™. Control is then passed to SPO_INTERRUPT where» 
if no other output is in progress»s a message is written to 


Station #2 indicating “non-transparent"s» “ETX™» and irrelevant 


datae Upon reading this message the handler will send an *E0T* 
to the host. | | | < | _— | 
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To send a "DLE EOT* Cdisconnect) to the host» the user gives 
RJE3780 the command *.E0T" or ".END*. In this case» a message 
will be sent to Station #2 with “transparent”, "ETX,» and 
irrelevant data. This wilt occur regardless of the state of 


RJE3780 Coutput in progress» etc.) and witlk result in the Line 
being disconnected by the handler. : | | 3 


“OPTIONS 


The only other major path in RJE3780 concerns the manipulation of 
various system parameters which can be affected by the user at 
run time. By using the appropriate command €".SU"» “".RO™, ™.TO") 
With one of the optionss the appropriate routine is entered 
CSET_OPTION> RESET_OPTIONs TEST_OPTION) and from there control is 
passed to the procedure which affects the chosen option 
CFIX <option>). In all cases» the final value of the option is 
displayed on the SPQ. a eH | 
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USER COMMANDS 


ALL user input to RJE3780 is entered via an ACCEPT, either from 
the SPO or from cards. All commands are of the form ".<command>* 


where the period (.) is used to signify to RJE3780 that tt 1s a 
user command and must be the first character in the record (no 


preceding blanks are permitted). If the period is missing Cor if 
it is not the first character in the record)» RJE3780 will assume 
it is a message record and pack it and transmit it to the host. 
The rest of this section covers ail the commands available to the 
user and the effect they have on the system. 


SBREAK™ = LINE BREAK 


Format: .BREAK 


o BRK 
This command is a combination of "RVI" and ™.CANCEL”™. It stops 
any ongoing transmissions to the host and halts any transmission 
coming from the host. No statement is made about ene state of 


the system after vee this command. 
@CANCEL™ - LINE BID SURRENDER - 
Format: CANCEL 
: ~CAN 
This command may also be ead: in response to the Peiection of a 
tine bide no matter what the cause. It forces RJE3780 to cease 
any further Line bid attempts with tne current message. Ail 


relevant data is cleared from the buffers» the input file is 
closed» and the system is returned to a normal state. 


"CLOSE" - TERMINATE SES SION 


AD LD CID OEY MET AEE AGES — SD GED CEE RM RE Ta Ee ce 


Format: eCLOSE 


This command js used to terminate the current session with the 


fhoste If there is no system activity» then a Line disconnect is 


sent to the host. If input or output is in progress» then a Line 
disconnect is sent when the current ach uy ity has ceased. 


tai‘ LINE DISCONNECT 
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TEND" = LINE DISCONNECT 


Format: .END 


This command is used to send a Line disconnect C*OLE EOT®). to the 
host. It takes effect immediately» regardless of any other 
activity in progress at the time. It does not reset the systema 
to any particular states, but merely interrupts whatever activity | 
is in progress to send the disconnect message. No statement is 

made about the state of the system having sent the disconnect. 


| 
| 


TEOF™ - END STREAM 


Format: .E0F 


This coamand 1s used in conjunction with the *Sx*™ commands. If a 
secondary file is calted for and cannot be found» this command 


causes further reading from primary and secondary files to cease 


and closes out the transmission by sending the contents of the 
current buffer with an "ETX*%» indicating the end of the message. 


This command ‘s sei: used in conjunction with restarting a stream 


Which has been interrupted by the host (via ‘RVI*). If the 


option for "“auto-mrestart™ is not set» it will close out the 
current input file and return the system to a normal state C1eees 


the rest of the file will not ne) sent). 


Format : sEOT 


The effect of this command is the same as for «END. 


Format: .FINI 


This command 1s used to uncondittonaliy terminate the current | 


session with the host. A “Line disconnect” is sent to the 
handler and the system goes to EQJ regardless of whether the Line 
is actually disconnected or nots or whether any input or output 
is in progress at the time. | | | 7 
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Format: 4.60 


This command is used in conjunction with the "Sx" commands. If a 
secondary file is called for and cannot be founds it causes 
processing to continue with the next card in the primary file 


Cieee.» the card calling for the secondary file is ignored = and 


reading continues from the primary card file). 


This command is also used in conjunction with restarting a stream 
which has been interrupted by the host (via RVI"). If the 
option for “*auto~restart™ is not sets it restarts the interrupted 
stream. Writing is enabled to the remote file» and RJE3780 takes 
up where it Left off» bidding for the line again and sending the 
rest of the interrupted message. 


"INT™ - INTERRUPT HOST 


Format: INT 


This command has the same effect as the .RVI command. 
SPHONE™ = AUTO-OITAL PHONE NUMBER 


Format > @ePHONE C=] fn} 
oPH C=) €n} 


This command is used to change the phone number to be used by the 
handler if auto-~dialout is used. The format of this command 15s 
".PHONE C=] n™ where the equal sign (=) is optional. If no value 
(nd) 185 present» the current value of the phone number as a 


changed by RJE3780 is pehted on the oP O. 


If the phone number has not deen changed since BOJ or since’ the 


last "eRESET™,» then the value displayed will be olank. 


Ifa value is presents it must consist of igus, and dashes (- ) 


and must be more than six (6) and tess than twenty-one (21) 


characters in length. If the fora of “n” is proper» then the 
value of the phone number in the handler for autoc-diatout is 
changed to reflect the new value. No check is made to determine 


whether the number is a valid phone number Cit 1s permissible to 
input a value of ail dashes). i 


BURROUGHS CORPORATION © COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP ss : B1000 RJE3780 
SANTA BARBARA PLANT | | | P.Se 2219 0391 REV C 


Dashes (-) are used as pause characters and are added at the 
user's discretion to give the phone hardware time enough to 
complete each digit ditated. The actuat format of the number 
input along with che time fFidl dashes is the user's 
responsibility. | | > ij 


Format: oe PRINT) 


oNEW.PRT 
»PRINTER 


Output print files from the host are printed continuously on the 
printer or go to one targe» continuous backup print file on disk. 
This command is used primarily when the print output is going to 


backup. It will allow the user to close the current active 
backup file immediately and open a new print file Cprobably 
backup) to continue writing to. In thts way it ts possible § (for 


the user to have his output on a number of moderate sized backup 
files rather than one very Large one. 


format: .PUNCH 
eNPU 
-NEW.PUN 


This command has the same effect as «.PRINT> except for punch 
files. a 


“RESIO™ = LINE BLO RETRY 


Format : eREBID 
oREG 


This command may be used in response to the rejection of a line 
bids no matter what the cause. It allows RJE3780 to try another | 
line bid sequence (since all necessary information is stilt 
present). There ts no Limit to the number of times a Line bid 
can be attempted with this command. If» after repeated attempts» 
‘the Line bid ts accepted» the transmission of the message (Cif 
- more than one block) continues in the normal fashion. | 


SRETRY" = SET RETRY LIMIT 
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) s BRESET™ = TERMINAL RESET 


Format; .RESET 
eRES 


This command has the same effect as restarting RJE3780. It 
clears all messages from the remote file and resets the system to 
an tnttiat starting condition with all system parameters set 


according to the current values of the program switches. The 
number of messages removed from both statton queues of RJE3780 15 
displayed on the SP9./ The Line is not disconnected» but an *E0T® 
is sent to the host before clearing the remote file to halt any 


activity which might be in progress. If the program switches 


have been changed since RJE3780 was executeds the new values wilt 
be reflected in the new vatues for the system parameters. This 
is avery unforgiving command and will be executed regardless of 
any other system activity in progress at the time. 


Format: oRETRY C=} mn a 


The format of this command is .RETRY f=] n» where the equal sign 
(=) is optionat. If the value of “"n”™ is omitted» the current 
value of the retry Limit is printed on the SPO. If a legal value 
of “n"™ is present Clegal heing 0 < n <« 16)5 the value of the 
retry limit is changed in the handler. If an illegal vatue is 
present» avalue of 15 is assumed and the retry limit is changed 

accordingly. | | 3 | | | 


Format s RO 
| RO <option> 
RO <option> f=] na 


see discussion under .50 option. 
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ZRVIS = INTERRUPT HOST 


Format: .RVI 


The effect of this command is to send an "E0T* to the host to 
halt any activity it may have in progress at the time. When the 
host ceases its activity» the user can try for control of the 
Line (with a “.REBID"» ".50", etc.) or take any other action 
desired. | 


#80" = SET OPTION 


Format: 2930 
e290 <oot ion> 
e590 <onotion> [=] n 


This commands along with *.RO™ and *.TO"» is used to change the 
various system parameters which are user modifiable. ".50" is 
used to set an option CTRUE). ".RO”" is used to reset an option 
(FALSE). And ".T0" is used to test and dispiay the values of the 
various options. _ — -? 3 a 


Each option will be discussed in turns in the USER. OPTIONS 
section. It should be noted that not all options are a simple. 
set/reset (eegex» PHONE)» though the majority are. Most options 
are given a value at system initialization. This is done by 
using various program switches to hold the initial values. By 
modifying the object file of RJE3780» it is possible to set these 
values to tailor the system to the user's individual defaults. 
(rather than to the release defaults) to suit a particular 
instatlation"s configuration. | 


For set/reset optionss the command format is ".50 <option>. for 
all other options» the format is *.50 <option> (C=] n™ where the 
equal sign (=) is optional and the value "n"” is within certain 
Limits. If the value "n"™ is omitted» a default value is usually 
assumed. 


cn 


so 
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| “SSTATUS" = SYSTEM STATUS 


Format: e STATUS 
—6e@ STAT 


This command enables the user to discover the current state of 
the system Cinput in progress»e» Line disconnected» etc.). 


"Sx" - START_READER/SEND 


"SO" = START READER COISK) 


Format: .5D {<file name>] 
Assumes the initial device for the input file will be disk 


and opens the appropriate <file name> on that device. 


SIR™ = START READER fEARDD 


Formats: eoOR (<file name>] 


Assumes the initial device for the input file wilt be a card. 
reader and opens the appropriate <file name> on that device. 


-— 


"ST" = START READER (TAPE) 


Format: .ST (<file name>] 
Assumes the initial device for the input file wilt be 
magnetic tape and opens the Sl ea <file name> on that 
Gownees _ 


This command is used to initiate file transmission to the host. 


it reads records from the appropriate file» packs them according 


to the current system options and» after having the Line bid 


accepted» transmits them to the host. Note that the <file name> 
as optional. If <fite name> is omitted» a name of 
*RJES7B0/CARDS" is assumed as default. | | 


EEREEEEEET aE cee citeh ote a 
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The transmission stream can be either a single file from one 
device» or multiple files from various devices sent as though 
they were a single contiguous file. RJE3780 begins readings 


packing» and sending records from the primary file Cspecified in 
the initial “"Sx"* command) until it reaches either the end of the 


file, or until it reads a record which begins with ".5D "> 
*'.SR ", or *.ST * as the first four (4). characters. In this 
fatter case» the rest of the record is scanned for a file name. 
If no name is founds the default name ("RJE3780/CARDS") is used. 
This secondary file is then opened on the appropriate device 
°C".50 "7 = disk» etc.) and reading and packing of. records 


continues from this secondary file. 


Onty primary and secondary files are allowed. Attempts to read 
from higher order files are ignored as commands and treated Like 
datae [In other wordse the "Sx" commands have meaning in a 


primary file as directions to a secondary» but in the secondary 
files the "Sx" commands are simply treated as part of the data. 


If the secondary file cannot be found on the specified device» 
the user is given the option of closing out the transmission at 
that point (".EOF") or to continue reading from the primary file 


~C".G0"). When the end of file is encountered while reading a 


secondary file» reading continues from the primary file from the 
point at which it left off last. When the end of file is 
encountered on the primary file» the message is terminated. At 
no point during the transmission is the host aware that it has 
recetved multiple files from multiple devices. All data is sent 
as if it came from a single file. | 7 


Ig" - TEST OPTION 


Format: ./79 | | 
 -1T0 <option> 
10D <option> ({=] n 


See discussion under .S0 option. 


2 a 


- BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP | ; a | B1000 RJE3780 


“SANTA BARBARA PLANT = — -PeSe 2219 0391 REV C 


USER OPTIONS 


These options are to be used with the “.RO">» "2.50" and *.7T0" 


commands (see USER COMMANDS section for further discussion of 
commands ). | | 


AUTODISC Option (set/reset) 


<option> 3::= AUTODISC 
| DS 
DISC 


This option determines whether RJE3780 automatically disconnects 
the tine after thirty seconds if there is no activity on the 
line. The value (30 seconds) is a system parameter and is not 


currently modifiable by the user. The release default for this 


option is RESET. The tnitiat value is determined by Program 


switch #3. 


AUTORESTART Option (set/reset) 


<option> :s= AUTORESTART 
| | AS | | 
RESTART 


This option is used if an "RVI* is received from the host. If 
after the host has finished with its transmissions this option is 
set» then RJE3780 wittl automaticatly bid for the Line and 
continue its transmission from where it |. was interrupted. 
Otherwise» the user will have the responsibility for restarting 
the transmission. The release default for this option its RESET. 


The inttial value is determined by Program Switch #4. 


<option> 2:= COMPRESS 


3Q 

COMP 
This option determines the format used to compress the data sent 
to the host. If this option is set» ail strings of blanks 
greater than one are compressed. If this option is reset» only 


the trailing blanks at the end of a record are compressed Cby 
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BUNCH Option (set/reset) 


<option> ::= PUNCH 


Similar to the “PRINTER™ option except used with punch files. 
(Also see and contrast with command ".PUNCH".) Release default is 
RESET. Initial value is determined by Program Switch #6. 


TELEPHONE Qotion (value) 


<option> st= PHONE {=] tn) 
| PH f=] (nj) _ | 
This option is the same as the * PHONE” commande | Both ".50" and 


“.RO"™ set a vatue for the auto-dialout phone number if one is 
provided. There is no initial vatue and no program switch 


connected with it. 


_ The foraat for testing the phone value is: 


.T0 PHONE £=] Cn} 


This wiil cause the aost recently changed value of the phone. 
number to be displayed. If the phane number has not been changed 


since BOJ or since the last ".RESET%» the vatue will be blank. 


In testing the value (".T0")» any equal sign (=) or value (n) 


present on the command tine will be ignored. 


that 
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TRANSPARENT Option (set/reset) 


<option> 3:3:= TRANSPARENT. 


TR 
TRAN 
~TRNSP 
TRANSP 
This option determines whether the message sent to the host is 
transmitted in transparent mode or not. If it is set» atl 
messages sent to the host wiil be transmitted in transparent 
modee This will assure that any control characters which might 


be imbedded in the message witl not affect the transmission. The 


option will have no effect upon messages received from the host» 


since the handler is responsible for accepting either form of 
message from the host. The release default for this option is 
RESET. The tnitiat value is determined by Program Switch #2. 
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LINE DISCIPLINE 


1. The handler» as presently devised» will not accept a message 
| block which begins with “SOH™ or “DOLE SOH™. Only an “"STX" 
or a "DLE STX" are accepted as proper beginnings of a 
message block. | ? 


Le An “ITB" character cannot be used as a tine control 


character due to a hardware restriction in the Bir-sync Line 
adapter. For this reasons» RJE3780 cannot emulate an IBM 
2780. | . 

36 The system» as currently devised» witt operate only in 
Point-to-Point mode. It will not support multipoint 
operation Cmultiple independent on-line terminals 


simultaneously attached to a common I/0 bus). 


4. An “end~of-media”™ CEM) punch control character (to send or. 
receive a “short card") is not handled as such but 15 


treated as part of the data to be sent or received. 


Se A "BEL" character will not be recognized as such by the 


handler or the MCS as the system is currently written. 


MCS NOTES 


L- Program Switches 


The program switches contain information which is used by the 


system to specify its internal configuration and run time 


- Parameters. These settings are looked at only at system 


initialization and when the "RESET" command is invoked. They may 


be dynamically modified while RJE3780 is runnings but will not 
take effect until ".RESET" is specified. | We give here the 
parameter which the program switch controls and the default 


value. 
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Program Switch #0 Space compression. (Default = 0 Ccompress)] 


Compresses alt multiple C>1) blanks in records 
when transmitting. [If vatue is 0 then blanks 


are truncated from the end and not compressed. 
See COMPRESS — option. 7 


Program Switch #1 SPO Hester. (Default = 0 €Cno lines displayed) ]} 


Will display the first n lLine(€s) of any 
printer output Cif non-blank) from the host on 
the operator console depending on the value of 
Switch i. Legal values are 0-15 (see DISPLAY 
option). 


Program Switch #2 Transmission mode. (Default = 0 (non-transparent) i 


: - Sends ail information to the host in 
4 7 e : | non-transparent modee. If value is ir then all 
ne | : data is sent in transparent mode. see 
fe Be | TRANSPARENT option. 


Program Switch #3 Auto-disconnect. COefaule = 0 Coperator)]) 


RJE3780 will not go to EDS without operator 
command. If value is 1 then RJE3780 will go 
to ENJ after 30 seconds. of inactivity. See 
AUTODISC option. 


Program Switch #4 Auto-restart. peer eunt = 0 (automatic) 


Automatically bids for the line and continues 
a transmission which was in progress when = an 
"RVI® was received from the host. Wilt not 
Did for the line if vatue was 0. See 
AUTORESTART option. a | | 


Program switch #5) Print files. (Default = 0 (cont inuous)]_ 


Will write print output to one iarae file. If 
value is i» then anew file is created for 
each output message Ci.ee, backup files). See 
PRINTER option. | | : 
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Punch fites. (Default = 0 Ccontinuous)) 


Will write punch output to one large file. If 


wvwatlue is I- then a new file is created for 


- Program Switch 7 


Program Switch £8 


Prograa Switch #9 


each output message (ieew.» backup files). See 
PUNCH option. | 


HOT READER (Default = 0 Cno HOT READER) I 


If the value is 1» then the MCS will treat the 
input primary file as a HOT READER Csee 
section 9). : : : 


AUTO SIGN-ON CDEFAULT = 0 (no AUTO SIGN-ON) 


If this value is set to ir RJE3780 will save 
the first record sent to the host as_ the 
sign-on record. If loss of data set ready. 
occurss RJE3780 will perform a spo cancel and 
automatically send the stgn-on messages If an 
ACU CAuto-Catt Unit) its not utilized, the 
operator is required to redial the host. 


Line connected. [Default = 9 (€disconnected)] 


The Line is assumed to be disconnected at 
system initialization and after a “RESET™. 
command. If the value ts Ll» then the line 1s 
assumed to be connected» even if this is not 
the case. This is necessary when using the 
autowdialout capability since the "Line 
connected™ indicator must show “connected” for 
any message to be sent to the handler’ for 
transmission. It is also useful for forcing a 
"Line connected” status should this need ever 
arise. 
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2- Record Size Specifications 


The release version of RJE3780 uses an I[/0 buffer of 562 bytes. 
Of this» 50 bytes are header informations leaving 512 bytes 
-avatitable for actual data to be sent or received. This value may 


be varied by changing the record size of AQFILE. This may he 
accomplished either by object code modifications (?M0 RJE3780 
FILE QFILE RECORD.SIZE = 45931] or at execution time (?EX RJE3780 
FILE QFILE RECORO.SIZE = 45037). Be warned that the handler will 
add up to 4& bytes (for STX Cor DLE STX] and ETX Cer OLE €£TX}) | 
when sending the message block. Also» the user MUST remember to 
include the 50 bytes for the header information in the total 
record size specification. <A record size less than 131 bytes C8l 
bytes data) 31s not allowed. A record size greater than 562 bytes 
total should not. be used unless modifications are made to the 


handler and to RJE3780. (See note 1 under HANDLER NOTES.) 


3- Oefault Inout Eile Name 


The name to be used if none is specified on the input command 
C".5D">» “2 OR" >» or ".ST") is taken from the FPS at system 
initialization and at ".RESET”. Consequently» if the user does 
not want to use the release name of "RJE37B0/CARDS"» the name 
Cand packwid) of INPUTFILE may be modified to suit the user. 
This can be done either at run time (£?—€X RJE3780 FILE INPUTFILE 
NAME = TOM/DICK PACK.ID = HARRY3] or by modification of the 
object file £€2?M0 RJE3780 FILE INPUTFILE NAME = WEE/WILLIE PACK.ID 


. = WINKLE, ]. The device type to be used will still be determined 


by the input command (€".50" for disks ".SR™ for cards» and "™.ST" 
for tape). It is only the default name to be used which can be 
specified in this manner. 


HANDLER NOTES 


‘“« Be The release version of the handler specifies a buffer size 


of 516 bytes in the TERMINAL sections. This is for an MCS 
record size of 562 bytes (512 bytes data» 50 bytes header 
information). It will also work for any record size less 
than 562 bytes. = | 


To determine the minimum buffer size to specify in the 
handlers, take the record size of QFILE from RJE37860> 
subtract 50» and add 8. BUFFERSIZE = (RSZ - 50) + 8B. Where. 
RSZ is the record size of AQFILE in RJE3780. (See also 

section 2 under MCS NOTES). : : 7 
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The IBM 3780 protocol allows for an ending block to be 
answered by a block with data. This is known as line. 
turnaround (see section 3). Should this ability of the 
protocol ever want to be used» the minimum buffer size 


should be multiplied by 2. This is because in NDL*s write 
tinked to a read» the transmitted message and the received 
message are both stored in the one [/0 buffer. 


In the STATION section of the handlers the user must define 
two identical stations on the Line. These stations must be 
#1 and #2 on the tine» since the CONTROL Cand REQUEST) 
expect this arrangement. A sample of the Last four sections 
of the handler is given at the end of this document. 
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OPERATING INSTRUCTIONS 


In the discussion which follows» it will be assumed that the 
object file (RJE3780) has already had alt program switches and 
file names modified to conform to what the user wishes to use as 
defaults. (See the appropriate sections relating to setting the 
options via the program switches and setting the input file name 
by modifying INPUTFILE for more information about these 
features). | | | 


EXECUTING RJE3Z80 AND HANDLER 


The first step is to execute RJE3780. This is accospdlished quite 
simply by entering “EX RJE37380" at the SPO. If a compatible 
handter ts not already running» then it will need to be started. 
If the handler to be used is already in the "C™ (Controtter) stot. 
of the Name Table (via "CM C <handler name>")» then tt wilt be 
Started automatically. Otherwise the user must start the handler 
manuaily by entering “EX <handler name>" at the SPGQ. 


PRINT FILES 


Note that as soon as RJE3780 has detected a compatible handler 
and established connections it opens the print file. This means 
that if it can find an unused printer» it will grab it and not 
relinquish control until EQJ Cor “.RESET"). Also refer to the 
"PRINT™ option. The punch file will not be opened until actuatly 
needed. But if the printer is needed for other tasks during the 
execution of RJE3780» then it should be saved prior to the 
execution of the handler» thereby sending the print output to 
backup until such times as the file may be closed and reopened 
C" RESET» ".SPRINT"» etce )e 


| , ign 


If the user does not have an ACU CAuto~Call Unit)» or is choosing 
not to use it» then this is the stage at which to dial-up the 
host station and establish connection. (If the user has an ACU 
and is using the auto-dial features the dialing and subsequent 
connection will be made during the first attempt to transmit data | 
to the host.) | 7 | 7 


- The user is now in a position to communicate with the host. In 

most installations» it will be necessary to signon to the host... 

- Depending upon the system to which the user 1s connected» the | 
_ proper procedure for signing~on will be different. Two methods 
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7 The content of <job stream> will be dependent upon the particular 


host instailation being used and the aims of the user submitting 
the stream for processing. | 


SESSION TERMINATION 


If the data comm line is still connected when the user wishes to 
end the sessions the *.CLOSE”" command will disconnect the tLine 


and send RJE3780 to EDJ as soon as all ongoing processing has 
ceased. Remember to send the sign-off card before entering 


"CLOSE" since RJE3780 will not allow any new transmissions to. 
the host after initiating the "close" sequence. “.FINI™ wilt not 
wait for ongoing processing to cease» but will attempt a Line 


disconnect and go to ENJ unconditionally. 


STA ATUS QUERY 


eT the user is ever curious about what the status of RJE378O iss 


the input command of ".STATUS" ont give him a brief description. 
of what it thinks it ts oNng 


RECOVERY/2 ESTART PROCEDURES 


When RJES780 does not. respond property ‘to. processing commands or 
it appears that the program is. Looping» there are various 


recovery procedures that should. be attempted before OS-ing the 


current job and re~executing the program. They are preferable 
_. because they avoid the oe. disconnect and re~establish 
-- processes that also result in the loss of all data currently. 
being transmitted. eG -. 


The least costly recovery PeuCedURS. is entry of either the "RVI" 


or the | "INT" commands. — These coamands interrupt the host and 
allow the ras to take control of. the liner. @ege» through a 
".REBIO"™ or an 25D" Cinitiate transmission of a file to the 


host)» epee ieee comaands do not. affect the state at open files 


por data being transmitted from the. host systems 


- If ev .RVIT or * INT" have no effect Cie@es -STATUS. panares the 
game state of the program)» users should then “*.RESET"™ RJE3780. 
This commands unfortunately» causes all open files to be closed 
and results in the Loss of all transmission data in the handter. 


Ite in effect» restarts the program and may require a 
disconnection and reestablishment of the datacomm connectian 
with the host system. It is preferable»r however» to merely 


 DS-ing RJE3780 and re-executing it. 
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RJE3780 contains an optional audit facility that can be used to 
trace the activity of the RJE3780/HANDLER in order to discover 
what errors are causing ttne problems. Auditing procedures 
require two steps to be taken: the ITOLOG option in the handler 
must be sete and the DC/AUDIT program must be executed. 


The IOLOG boolean is set by entering the job number of the 
currently executing RJE3780/HANOLER and the T9L0G command: 


<j ob-number >AXTOLOG 


The handler itself wilt open the audit file and begin its 
auditing procedures. 


The second step involves executing OC/AUDIT» a released program 
that is available for auditing line activity. DC/AUDIT knows 
which audit file it is looking for and requires no file-equation 
if the IOLOG option has been set normally. It begins to process 
the audit file and wilt continue to do so until the audit file is 
closed. The audit file is closed when the user re-enters the 
1OL0G command again: | = 


<job~number of the RJE3780/HANDLER> AX IOLOG 


Re~entry of the command resets the wdee pentean and closes”7 the 
audit file. It makes no difference whether the audit file is 
open or closed when DC/AUDIT is executed. However» users must — 
note that DC/AUDIT wail not go to E0J until the file is closed 
and that if a closed audit file is re-opened before the original 
audit file has been analyzed and printed out» the open removes. 
‘the old file. | 5 a 


“When DC/AUDIT goes to 30J» it displays a message asking whether 
or not it should use its default parameters for analysis and 
printing of the ane file. Normal response to the program 
should be: | | 


re of DC/AUDIT>AXADDRESS END 


the response produces a printout that would cover most. 
circumstances in which there are Line problems. If users wish a 
more specialized oprintout» they should consult the DC/AUDIT 
Product Specification» P. 5S. 2212 5421 for information about how. 
to specify special audit procedures. 


4) 


FINI 
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SAMPLE HANDLER SECTIONS 


RRRELRERERREALRARLANE ALLL ALL ALT SELTLTETELTTLELESTETETEEAT ESTEE 


RAED | TERMINAL SECTION | hi ay a 


SELES SSE STSSSESESESESTSERTSTELERTEESESTEE TESTE SESE SETS VLLLULALLA 
4 
TERMINAL IBMHOST: z : | 

BUFFERSIZE = 516- 2% TRANSMIT & RECEIVE 5S16-#YTE 

| > & Z BUFFERS-See Section 6 HANDLER 
: | Z NOTES» Note 1 

ADDRESS = 0. 2 : 
TRANSMISSION = 0. 2 | 
REQUEST = RAE STE ORGS TR ECE IVCs RJES7TBORQST2TRANSMIT. 
: | : , | 


LLRLLAULAK ALLA AULA RAL LLAL LALLA LA LLLAL UL AL ARULALALLAAL ALLL LALAUY 
Z“L2UZ STATION SECTION “LLL 
ULLAL LALLA IIA AIA I I III IAAI 
Z 
STATION IBMSTATNLIS Zz. 
MYUSE = INPUT»OUTPUT. 2 | 
PHONE = * | | ". 2% FOR AUTO-DIALOUT ONLY 
RETRY = 15. 2 | 
CONTROLLER = FALSE. 2 
TERMINAL = ISBMHOST. 2z 
STATION IBMSTATN2: Z 
MYUSE = INPUT»OUTPUT. 2 | | | 
PHONE = * | | *. % FOR AUTO<DIALOUT ONLY 
RETRY = 15. 2% | 
CONTROLLER = FALSE. £& 
TERMINAL = I8MHOST. 2z 


4 
pA 


— ALLL LAL LRA AL AALAL AL LALLA LALLA LAL LALLA AA ULE 
LLEE | LINE SECTION | nahin 


SELTTSTSELETTETTSETETTTTESELEEETETTETTTTETTTTETTTETTEET TTT 
_ | : | 

LINE SISYNCSWITCH: Z ea 

RJES78OCNTRL. Z 


CONTROL = 
STATION = IBMSTATINi» IBMSTATN2. 2 
7 ADDRESS = 13021. Z% : 
a ao | 
y ' 


ZURZLL ALL LL ALK LL ALLA AAZ ULLAL ALAA ALLL ULLAL ALLL LLAMA, 


RAZZ | | FILE SECTION a L242 
TISTtLSSLESLCe Lote Stes etieise ester acecesecetesececetee ices esis: 


a 4 


FILE RJE376002 x 
FAMILY = ALL. Zz 
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HOT READER 


The HOT READER function for the RJE37680 program 15 tnvoked by 
setting program switch seven at 8B0J. If this switch is equal to 
1 CSW7=1)5 jthen the RJE3780 orogram will force the tnput primary 
file device type to be CARD.READER. It witlk then open an input 
priwary card file» whose internal name is "CARDS". If the file 
is presents» i.e.» the open completes» the program wilt bid for. 
the Line. If accepted» it wilt start sending the file. 


If RJE3780 is executed with the hot reader option set and the 


stream deck is missinger RJE3780 will prompt the operator to load 
the stream deck prior to establishing connection with the host 
system. If connection is established and the stream deck is 
still missings RJE3760 will go to EQJ. : 


If the Line is in use by the HOST at the time a Line bid is 


attempted» the RJE3780 program will wait until the HOST gives up 


control of the Lines: at which time the line bid will be attempted 


again. 


-RJE3780 will check the value of SWZ at 803° and set a flag 
indicating the user. desires to invoke the HOT READER function. — 


Since the value its tested only at 80J- the HOT READER functions | 


once turned one may not be turned off. 


While running with a HOT READER» the stream deck» i.see» the input 
primary file» remains open. Any card put into the reader will be 


scanned by the RJ£3780 program. The program will be looking for. 


a "<2?>END™, a “<?>D0ATA™> or a "Sx" card. Eather an END or a 


DATA card witt cause an EOF indicator to be sent to the HOST for 


the current file. The next card encountered by the card reader 


will cause the start if anew file is to be sent to the HOST. A 


"25x" card will be processed as a request to start sending a 
secondary file to tne 10ST» just as a normal operation (Crunning 


without a HOT READER). 


When EOF is encountered on the input primary file» the RJE3780 


program wilt send an €NF indicator to the HOST for the current 


file being transmitted if necessary» clase all open files» and go 
to EOJ. EOF on the input primary file is received uhen a 


"<?>TERMINATE” card is read from the HOT READER. : 
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‘A change has been made to a ".STATUS*® querye The display wilt 
include an indication as to whether or not a HOT READER is being 
‘used. Also changed is that a ".5x" from the SPO is no Longer 
valid if a HOT READER is invoked. 


NOTE? Normatly the MCP will treat cards with a question mark (2) _ 
| 1n column one as control cards. When using a stream deck» 
cards between the STREAM card and the TERMINATE card which 

begin with a question mark in column one witl not be 
treated as controt cards. They will be treated as regular 


input cards. Only cards heginning with an invatid 
Character» as indicated by <?>»5 will be treated as control 


cards. For further information see the System Operation 
Guides section 2. . 
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The following is a list of alt possible messages which might be 
displayed by RJE37890 and its handler. Included with each message 
is a short description of what the message means and if any 
action should be ‘taken. Most of the messages are merely 


informative and frequire no action on the part of the user. Nf 


these» a large number will never he seen by the users since they 
will never appear in the normal course of operation. | 


The messages are separated into messages from the handler and 
messages from RJE3780. As a general rules messages from the 
handler are merely informative» and are usually associated with a 
message from the MCS CRJE3780). | 


HANDLER MESSAGES 


AUTO-CALL UNIT POWERED OFF 


This message indicates there is an autoccall unit hooked to 
the system which is not powered upe~ If processing 1s to 
proceeds the unit should be powered up or the diating 
performed manually. 7 3 


BAD RESPONSE To *TTD® 


The handler has received DLE<etwas> from the host as a 
response to a TT0. (<etwas> is other than EOT). This 1s an 
informative message only. oe | 


CALL ABANDONED - CHECK PHONE ¢ 


For any of a number of reasons Citlegal phone number, 
auto~call unit not strapped for the correct tines etc.) the 
call has been abandoned. This is an informative message. 
Further action is up to the user regarding a cures. — | 


CRETE PEPE EEE UPEPES ET EEEPSE) DBP PREDERPPEEE 
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EXCEPTION DETECTED ON "TTD 


The handler has detected an exception (parity» timeouts etc.) 
on the Line while waiting for a response to a TTD. This is 
an informative message only. No action need be taken. 


EXCEPTION ON LINE BID RECEPTION 
While in a “Wait For Bid™ states the handler has - detected 
some exception on the line Cparity» loss of data set ready» 
etce). This is an informative message only. 
IMPROPER LINE BID RECEIVED 
While in a “Wait For Bid" state» the handler thas received 
some data other than cNQ. This is an informative message 
onty. No action need be taken. | 
IMPROPER RESPONSE TO. TIMEQUT 
While waiting for a response from the host Cafter timing 
out )» the handler has received what it considers to be an 
invalid response. This is an informative message onty. | 
IMPROPCR RESPONSE TO "TTD! 
The handler has sent a TTD to the host and received an 


incorrect response. This is an informative message only. No 
action need be taken. 


LINE BIT ACCEPTED 


This spo message is St peeved: when the line bid record W"FNQ" 
1s accepted by the host. 
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LINE TS BUSY 


The autor-catt unitt has detected that the number it tried to 


dial is busy. The catt has been abandoned. | This aS an 
informative message only. No handler related action need be 
taken. | | 


-*NAK® RECEIVED TO LINE BID 


This message indicates that the randter has specifically been 
denied controk of the datacomm line on a Line bid attempt. 
This ts an informative message only. No handler retated 
action need be taken. ae | 


RETRIES EXCEEDED ON "ENQ® 


The handler has exceeded the current retry limit white 
sending ENQ"s to the host» or incorrect ACKO/ACK1 was 
recetved during transmission. ' Transmission is being 
terminated. This is an informative message only. 


RETRY LIMIT EXCEEDED ON LINE BID 


This message indicates that the handler has exceeded’ the 
current retry Limit while bidding for control of the dataconmm 
line. This 1s an informative message only. No action 
related to the handler need be taken. 


RETRY LIMIT EXCEEDED ON WRITE 


The handler has exceeded the current retry Limit while trying 
to send a message block without getting a proper response 
from the host. Transmission is being terminated. This s an 
informative message only. | | 
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TIMEOQUI. SY HOST - AWAITING RESPONSE 


While waiting for a message block from the hostp the handler 
has timed out (nominal 27-3 secend timeout for <si-Sync 
adapter). This is an informative message only. 


WAITING FOR MCS QUEUE NOT FULL 


The handler has a message to queue for the MCS but the queue 
is full. The handler will NAK any further messages from the 
host until the queue full condition 1s retieved. Thts 
message will be displayed every ttme the number of NAKs 
equals the retry tlLimit. | This condition most frequently 
occurs because a physical output device (1.@.% printer or 
punch) is not ready while in use» possibly combined with a 
smatl value for 9.MAX.MESSAGES CQMX) in the MCS. | 


10 SECOND TIMEOUT - WAITING HOST RESPONSE 


The handler has waited ten (190) seconds for a response to a 
time-out by the host. This is an informative message only. 


60 SECOND TIMEOUT ON DIALING 


The auto-call unit has waited 60 seconds without a response. 
The call has been abandoned. This 1S an informative message 
only.» No handler related action need be taken. 7 | 


ee em, Scone SE) as ED ab > ep em ee ee ee RO 


AUTODISC = n 


This message displays the newest setting of the 
auto-dtisconnect option Ci=auto-disconnect»s — O=operator 
disconnect) in response to an AUTODISC option command. 
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AUTORESTART = n 


This message displays the newest setting of the auto~restart 
option Cl=auto-restart» O=operator restart) in response to an 
AUTORESTART option command. | _ | | 


AUTO SIGN-ON IN PROGRESS 


This spo message informs the user that the sign-on message 


has been rewconstructed and will be sent upon re~establishing 
connection with the host. 


AWAITING A "LINE BID*, ".REBID"» OR ".CANCEL® 


This message 1s displayed in response to a *.STATUS™ command 
when the system is waiting to get a Line bid accepted» or 
when it is watting for “.RE3ID" or “.CANCEL” from the user. 
If no message has been displayed earlier indicating that the 
system.is waiting for ".REBIO"™ or *.CANCEL™» then no action 
need be taken. : 


AWAITING ".G0" OR “.EOF" 


This message is displayed in response to a ™.STATUS*®™ command 
when the system iS waiting for *.G0" or *.E0F" from the user. 
The user should enter one or the other of these commands. 


AWAITING SHUT-DOWN - REQUEST IGNORED 


This message is displayed in response to various user 
commands when RJE3780 is in the process of closing down. The 
command has been ignored. RJE3789 wilt come to ED0J as soon 
as all processing has ceased. | 


CLOSE PENDING 


This message is displayed in response to a “s5TATUS"” command 
when the system is in the process of closing~down in response 
to a *.CLOSE™ command entered earlier. 


fed 
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COMPRESS = n 


This message displays the newest - setting of the compress. 
option (1=compress>» =Nno compression) in response to a 
COMPRESS option command. 


CONNECTION ESTABLISHED - WAITING 


This message indicates that the datacomm connection with the 
host has been coapleted and data transmisston and reception 
may now commence. 


DATA AFTER TAB FORMAT ~ IGNORED 


A record has been received from the host with horizontat tab 
format information and data following the tab format. This 
ts not ablowed and the data in this record fatllowing the 
horizontal tab format has been ignored. 


DISPLAY =n 


This message displays the newest value for the number of 
first Lines to be displayed when receiving a new message from 


the hoste This display appears in response to a DISPLAY. 
option command. 


END OF FILE ENCOUNTERED ON PRINT 


An “End-of-File”™ condition has been detected when trying to 
print a record. No action 1s taken» and the record is not 
retried. Processing continues as if no error had occurred. 


END OF FILE ENCOUNTERED ON PUNCH 


An "End-Of-File™ condition has been detected when trying to 
punch a record. No action is takens and the record is not 
retried.j Processing continues as if no error had occurred. 
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ENTER ".GO" OR "EOF" FOR INTERRUPTED STREAM 


This message indicates that while sending data to the host» 
RJE3780 received an interrupt from the host so tt could send 
a message. That message has completed» and the user must now 
enter %“.G0" to continue transmission of the interrupted data 
stream to the host» or ".EO0F" to send the end of stream 
indicator to the host and cease further transmission of that 
streame . 


".EOF™ NOT VALIO IN THIS CONTEXT 


This message is displayed in response to an ".,EOF"™ command 
when the system 18 not expecting a ".G0" or “.EOF™ from the 
user. The command is tgnored. No action need be taken. 


*EOT® RECEIVED FROM HOST 
ENTER *.REBID® OR *. CANCEL” 


This message indicates that an E0T has been received from the 
host which is not an end-oftinput indicator. RJE3780 has 
data to transmit and the user should enter “eREBID™ to bid 
and attempt to send the data» or “.CANCEL” to discard and 
ignore the data it has for transmission. 


*EOT*® RECEIVED FROM THE HOST 
TRANSMISSION TERMINATED 


This message indicates that an EQT has been received from the 
host Which is =e not an end-of-input indicator. i £ Any 
transmission RJE373890 may have had in progress is terminated 
and the data discarded. 


ERROR = RECORD ENDED WITH "IGS? 


White unpacking a message block which has been received 
compressed» a punch record (delimited dy IRS) has been found 
which ends with been rec-constructed and will be sent upon 
re-establishing connection with the host. the [G5 character. 
The records as currently constituted» © is puncheds = and 
unpacking continues with the next record. > 


Ans 
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ERROR - RECORD TERMINATES ON "IGS" 


While unpacking a message block which has been received 
compressed» a print records (delimited by IRS) has been founda 
which ends with the IGS character. fhe records» as currently 
constituted» 1S printed» and unpacking continues with the 
next record. | 


ESCAPE SEQUENCE DETECTED IN TAY FORMAT - “RES oT OF FORMAT IGNORED 


An €SC character has been detected in a enue tab format 
record. Everything following the tab format information 
Cheginning with the ESC) has been ignored. The tab format is 
determined by the data preceding the ESC character. 


FILE NAME “<file name>™ —S ILLEGAL 


This message is displayed in response to various’ user 
commands when the file name in the command is illegal. The 
command has been itgnored. Re~entering the command with the 
Legal file name should work. : 


FILE "<file nane>" MISSING. ENTER ".G0" OR " .E0F * 


This message is displayed during transmission Cout) upon 
discovering that a requested secondary file (<fitle name>) 
does not exist on the designated eeu ice The user can etrther 
terminate the stream by entering an “.E0F" or continue with 

the next record from the primary file by entering *.G0". The- 
record dn error 1S tgnored. : 


FILE “<file name>” MISSING. REQUEST IGNORED. 
This message is displayed in response to an “.5" comaand when 


the file is not present on the specified device. The ™.S" 
command is ignored» and the system waits for further input. 
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".G0" NOT VALID IN THIS CONTEXT 


This message is displayec in response to a ”.G0" command when 
the system is not expecting a ™.G0" or “.EOF”™ from the user. 
The command is ignored. No action need be taken. 


IOLE 


This message is displayed in reply to a *.STATUS™ command 
when RJE3789 is in a quiescent § state. {t means that no 
activity %s currently tn progress» and the system is prepared 
to act on any command. | | 


[MPOSSI3LE CONDITION REACHED WHILE UNPACKING 


This is a catch-all message displayed when RJE3730 encounters 
some unexpected probdlem while unpacking a message block. No 
statement is made about the veracity of the information in 
this records or the processing of the rest of the information 
an the block. This is an informative warning only. RJE3730 
will eventually untangle itself and processing wiil continue 
correctly with the next message plock. 


IMPOSSISLE 0 CONDITION REACHED ON SCAN 


This message is displayed when a null option is found. It 
indtcates. either very bad inputs» interpreter problems» or 
hardware problems. 


IMPROPER "ESC*® SEQUENCE 


This message is displayed if an €SC character is detected 
which itis followed by an invalid qualifier. The invalid 
qualifier is ignored» and unpacking continues as though the 
improper ESC sequence had not been tin the message btock. 
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INCOMPLETE ".RO" CUMMAND 


An option command | of “2RO" has been entered with no option 
specified. The command is ignored. No action need he taken. 


INCOMPLETE 7.50" COMMAND 


An option command of ".S0" has been entered with no option 
soecified.. The command is ignored. No action need be taken. 


INCOMPLETE I/70 ON PRINT 


An "Incomplete I/0" condition has been detected when trying 
to print a record. No action is takens and the record is not 
retried. Processing continues as if no error has occurred. 


INCOMPLETE I/70 ON PUNCH 


An "Incomptete I/9" condition has been detected when trying 
to punch a record. No action is taken» and the record is not 
retried. Processing continues as if no error has occurred. 


INCOMPLETE 170 ON QUEUE WRITE 


This message is displayed when a message block is written to 
the handler by the MCS for transmission to the host and finds 
the communication queue full. No action need be taken since 
this message should never be disptayed. Processing . 
Ctransmission) with continue correctly regardless. 


INPUT CURRENTLY IN PROGRESS 


This message is displayed in response to various user 
commands when input 18 being received from the host. The 
command has been ignored. Transmission from the host must 
cease before the command will have any effect. 
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INPUT IN PROGRESS 


This message is displayed in response to a "STATUS" command 
when the system is in the process of receiving input from the 
hoste No action need be taken. 3 


INVALIO COMMAND 


1/70 


[/0 


This message 1s disptayed in response to an input of ".TEST". 
The tinput 18 itgnored and processing continues. 


INVALID ENTRY IN ".RETRY™ COMMAND 


This message is displayed in response to 2 *.RETRY” command 
when the characters following the ".RETRY™ are non-numeric. 
The cowmand ts ignored. No action need be takens. _ 


ERROR ON PRINT . 

An “Exception™ condition has been detected when trying to 
print a record. No action is taken» and the record is not. 
retried. Processing continues as if no error had occurred. 
ERROR ON PUNCH 

An "Exception" condition has been detected when trying to 


punch a record. No action is taken» and the record is not 
retried. Processing continues as if no error had occurred. — 


<INTEGER> MESSAGES REMOVED FROM LSN <INTEGER> 


This spo message indicates the number of messages removed 
from the station queues of RJE3780 during a “.RESET”™ terminal 
conmand. _ by | | ; 
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LINE B10 REJECTED 


ENTER *.REBID" OR “CANCEL” 


This message is displayed if the host either rejects or 
Ignores an attempt to bid for the tine (CNAK received from 
host» retry limit exceeded» etc.). . No other data 
transmission to the host is possible until a ™.REBID" or 
".CANCEL™” is entered. | 


LINE DISCONNECTED 


This message is displayed in response to a “.STATUS™ command 
when the datacomm Line is disconnected. The user might want 
to reconnect the tine if further processing is desired. 


LINE DISCONNECTED. 


This message indicates that the datacomm line has been 
disconnected and no processing will continue until the tlLine 
is reconnected. No transmission or reception was in progress 
at the time. | : | 


LINE DISCONNECTED. IF NOT ACU» PLEASE REDIAL HOST. 
OR ; 


"LINE DISCONNECTED. PLEASE REDIAL HOST. 


These spo messages indicate that the line has become 
disconnected and auto sign-on has begun. If the previous 
connection has been obtained through an ACU» the first 
message is displayed, otherwise» the second message is 
displayed. | “a3 


LINE STILL DISCONNECTED 


This message is displayed in response to various user 
coamands when the Line is disconnected. The user command has 
been tgnored and a connection must be Penacenagee paTne any 
of these commands will have an effect. 
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NO DATA TO BID WITH 


This message is displayed in response to a “.REBIBD®™ command 
when there 1S no data present with which to initiate 
transmission to the host. The request ts ignored. 


NO HANDLER RUNNING 


This message is displayed. when the handler goes to EOJ» 
normal or abnormal (COS or OP). The MCS will also go to ENJ 
at this point. os 


NOT ALLOWED IN HOT READER MODE 


This message is in response to a moSK" command from the local 
SPO. When using the HOT READER function» a "25x" is only 
valid in the stream deck. | 


NOT ENOUGH CHARS FOR PHONE NUMBER - IGNORED 


This message is disptayed if there are fewer than / phone 
characters present when changing the phone number. The 
command is tgnored. No action need be taken. 


PHONE = <phone number> . 


This message is disptayed in response to a PHONE option 
command or a PHONE command. It displays the Latest value of 
the phone number as known by RJE3780. If no value 1S given. 
in the commands (thereby constituting a query)» the value 
displayed is correct only if the value has been changed by 
RJE3780 since 30J or “".RESET"™. 


PLEASE CONNECT AND ENTER “.REBID® OR *.CANCEL™ 


This message indicates that the datacomm Line has been 
disconnected while a line bid was in progress. The user can 
either enter “.CANCEL" to discard the attempted tine bid 
data» or reconnect the line and enter “.REBID™ to cantinue to 
bid for the Line and attempt transmission of the datae 
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PRIMARY FILE = "STREAM DECK" 


This spo message indicates that the hot reader has opened the 
stream deck file. 
PRIMARY FILE FLUSHED: <FILE NAME> 
| This spo message indicates the name of the primary file 
closed and flushed from the system during a spo ".CANCEL". 
PRIMARY FILE IS <FILE NAME> 
This spo message is a “.STATUS™ command response indicating 
the name of the current primary file. | - : 
PRIMARY FILE "<FILE NAME>* OPENED 
This spo message 15 displayed when RJE 3780 opens a primary 
file. : | 
PRINTER =n 
This message displays the newest setting for the new oprint 


fife option (il=separate filesr O=single file) in response to 
a PRINTER option command. Se 2 7 


PROBLEM ENCOUNTERED ON LINE 


This is a catch-all message when some problem (unspecified) 
occurs on the datacoam line. Some examples might be parity» 
loss of data set ready» toss of carriers etCe. 


PUNCH = n 


This message displays the newest setting for the new punch 
file option Cl=separate files» O=singie file) in response to 
a PUNCH option command. | | | 
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READER ACTIVE 
This message is displayed in response to a “.STATUS"” command 


when the system 15 in the process of transmitting data to the 
host. No action need be taken. 


READER ALREADY ACTIVE 


This message is displayed in response to various user 


commands when a reader is already active. CTransmisston is 
in progress). The command has been ignored. The orevious | 
reader must be closed before the command wittl have any 


effect. 


READER CLOSED 


This message indicates that the MCS has just completed 
transmission of a data stream or a control character to the 
handler Cwhich governs transmission to the host). It does 
not mean that the data has been transmitted to the host. No 
action is necessary. This is an informative message only. 


RECORD SIZE TOO LARGE - SIZE SET TO 512 BYTES 


RJE3780 has been executed with a record size for QFILE which 
1S greater than 562 (512 data bytes). Only the first 562 
bytes (for 512 bytes of data) will be used for transmission. 


RETRY LIMIT = n 


This message displays the newest value of the retry Limit as 
known by RJE3780 in response to a RETRY option command. This 
value may be wrong if the value originally given for the | 
retry Limit in the program (15) is incorrect and the ".RETRY® 
command has not been invoked since the most recent B0J = or 
"RESET". | 
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SECONDARY FILE FLUSHED: <FILE NAME> 


This spo message indicates the name of the secondary file 
closed and flushed from the system during a spo *™.CANCEL”. 
SECONDARY FILE IS <FILE NAME> 
This spo message is a ".STATUS"™ command response indicating 
“the mame of the current secondary file. 
SECONDARY FILE "<FILE NAME>” OPENED 


This spo message is displayed when RJE3780 opens a secondary 
file. | | 


STREAM DECK MISSING 
PLEASE LOAD READER WITH STREAM DECK 3EF ORE 
ESTABLISHING CONNECTION 


This spo message indicates that che. hot reader was requested 
(SW=7) but the stream deck was not oresent. The user is 
prompted to toad the stream deck prior to establishing 

connection with the host. 


STREAM DECK STILL MISSING. GOOB8YEI 


This spo message indicates that the hot reader was requested 
and the stream deck was not present when connection with the 
host was established. In this situations RJE3780 goes to 
E0J. : : 


TAB FORMAT NOT TERMINATED PROPERLY ~ REST OF FORMAT IGNORED 


A norizontal tab format record has not been terminated 
correctly. The format information is taken from the data 
preceding the. improper termination, and the rest of the data 
in the. record is ignored. oO 
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THE INPUT FILE IS A HOT READER AND 


This message is in response to a ".STATUS™ SPO input. It 
indicates that the HUT READER function has heen invoked. The 
Standard response will follow on the next Line. 


TOO MANY CHARS IN PHONE NUMBER - IGNORED 


This message is displayed when there are more than 20 phone 
Characters present when changing the phone number. The 
command 3s tgnored. No action need be taken. | 


TRANSFER WAS IN PRUGRESS 
LINE DISCONNECTED. ~ 


This message indicates that the datacomm tLine was 
disconnected while transmission or reception was in progress. 
The system will wait for a connection before any further 
atteapts at transmission. | 


TRANSPARENT = n 
This message displays the newest setting of the transparent 
transmission option (Cil=transparent>» O=non-transparent) in 
response to a TRANSPARENT option command. 

USEABLE RECORD SiZt OF "OFILE” LESS THAN 81 BYTES. 
RJE3780 has been executed with a record size for QFILE which 
is tess than 131 (81 bytes for transmission data). The 
record size for QFILE must be modified before RJE3780 will be 
allowed to run. | 

WARNING - INCOMPLETE "ESC*® SEQUENCE 


An ESC character has been detected in a print block which is 


not followed by a qualifier. Unpacking of the record. ends 
With this character and the records as currently constituted», 


is printed. Unpacking continues with the next record in the_ 
block. | : | | 
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WARNING - PRINT BUFFER OVERFLOW | 


This message is displayed when unpacking a print message 
block and encountering a record which is longer than the 
_atltotted 132 print characters. Only the first 132 characters. 
are printed and unpacking: continues. with the next record. 


WARNING = PUNCH SUFFER OVERFLOU 


This message is displayed: “when. unpacking a punch message 
block and encountering a record which is longer than the 
allotted 80 punch. characters. ‘Onty the first 80 characters 
are punered and: unpacking cont Inues with the. next record. 


WARNING : RECORD ‘NOT DELIMITED WITH AIRSt 


White unpacking. a message block coe the host» the last 
record of the block was found to be missing an IRS character. 
No statement is made about the veracity of this record since 
some information may have been tost somewhere in transit. 
Processing continues in a normal fashion. No action need be 
taken. a . ‘a : | 


_» “<input>™ IS AN INVALIO OPTION — 


An option command CRO» SO» or TO) has been entered with an 
option which ts not valid. The command is tgnored. No 
action need be taken. Oo | : 3 


"<input>*™ ~ UNKNOWN COMMAND 


This message is displayed in reply to an input command to 
RJE3780 which is not recognized as a legal command. The 
input is ignored and processing continues normally. 
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<?END> CARD MESSING - EOF ASSUMED 


This message appears on the SPO whenever a card deck is being 
sent to the HOST and a <?>9ATA card is read before an <?>END 
card. The RJE3780 program assumes that the user wishes to 
start sending a new deck» and therefores end the deck 
currently heing sent. oo | 
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"ST" = START READER CTAPE) 
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"Sx" = START_READER/SEND 4 


BURROUGHS CORPORATION 
“ COMPUTER SYSTEMS GROUP 
“~SANTA BARBARA PLANT 


INDEX 


CPunch/Print)-Unpack Event S72 


"BREAK™ = LINE BREAK 4-1. 


~ "CANCEL™ = LINE BID SURRENDER 4-1 
“CLOSE™* = TERMINATE SESSION 4-1 


"END" = LINE DISCONNECT 4-2 
"EOF™ ~ END STREAK 4-2 : 
PEOT™ - LINE DISCONNECT 4-2 
"FINIT - ABORT SESSION 4-2 
"GO" - CONTINUE STREAM 4-3 
"INT" = INTERRUPT HOST 4-3 
"PHONE™ = AUTO-OIAL PHONE NUMBER 
“PRINT™ - START NEW PRINT FILE = 4 
“PUNCH™ = START NEW PUNCH FILE 4- 
"REBID™ - LINE BID RETRY 4-4 


—SRESET™ = TERMINAL RESET Ae5 


"RETRY" - SET RETRY LIMIT 4-5 
"RO" - RESET OPTION 4-5 
"RyI" - INTERRUPT HOST 4-6 


"SD" = START READER CDISK) 4-7 


"SO" - SET OPTION 4-6 
"SR" = START READER CCARD) 


"STATUS" = SYSTEM STATUS 
"Ta" - TEST OPTION 4-8 
APPENDIX As ERROR MESSAGES A-1 
AUDIT PROCEDURES 7-4 | 


AUTODISC Option (set/reset) 5-1 
AUTORESTART Option (set/reset) S-1 


COMMUNICATION WITH RJE3780 .«.«-_ 21 
COMPRESS Option (Cset/reset) 5-1 


Default Input File Name 6-4 
DISPLAY Option (value) ae e 


‘ESTABLISHING DATACOMM CONNECTION 7-1 
EXECUTING RJE3780 ANO HANDLER = 7-1 


EXECUTION PATHS AND STATES 2-2 


HANDLER MESSAGES A~1 


Pep ncasnh Ream aerinecaekcare treimesnre mnt eee eR 


IX-1 


COMPANY CONFIDENTIAL 
81000 RJE3790 
P.S. 2215 9391 REV C 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
_. SANTA BARBARA PLANT 


HANDLER NOTES 674 
HOT READER 9-1 


Initiate Transmit 3°7 
INTRODUCTION i-1 


Line Bid 2-2 | 

LINE BED AND MESSAGE TRANSMISSION 
LINE DISCIPLINE 6-1 

LINE DISCONNECT - RECEPTION 2-5 


LINE DISCONNECT - TRANSMISSION ‘fe 


LOSS OF DATA SET READY 2-6 


MAIN LOOP - WAIT STATEMENT 3-1 
MCS NOTES 6-1. 


Message Reception 3-9 
MESSAGE RECEPTION 274 
Message Transmission 2-5 


GPERATING INSTRUCTIONS 7-1 
‘OPTIONS 3-11 


PRINT FILES 7~i 

PRINTER Option (Cset/reset) 5-2 
Progran Switches 5-1 

PUNCH Option (set/reset) 5-73. 


Q (Remote File) Read Event 3-2 
Q@ (Remote File) Write Event S22 


~Read=Pack Event 3-2 


Record Size Specifications 6-3 
RECOVERY/RESTART PROCEDURES (-3 
RELATED DOCUMENTATION  i-2 
Remote File Read 3-3 

REVERSE INTERRUPT - CRYI) 2-6 
RJE3789 371 

RJE3780 MESSAGES An4. 

RJE3789 PACKAGE i-1 
RJES7B80/HANDLER 21 
RJESTSQ/HANDLER AS FSA 2-1 


SAMPLE HANDLER SECTIONS 8-1 
~ SESSION TERMINATION 7-3 
SIGNING ON AND OFF 7-2 

SPO Event 3-1. 

STATUS QUERY 7-3 


- TELEPHONE Option (value) 5-3 
TEMPORARY TEXT DELAY - (ITD) 2-7 


IX-2. 


COMPANY CONFIDENTIAL 
B1000 RJE3730 


P.S. 2219 03591 REV C. 


Copernic CORP ROR CSser ih bese Pee ten ot Mee Se rn Te eg ee a ee ei Re, act ea et es Seo, OE ee, Ft ae, TS, ee se en ES et! Mp OR, Se eee PS ee ane, eee ne) ee 


Las 
eae 


LSS LG ENT EY SERRA SE GUDRUN Ty 


IX-3 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL ~ 
COMPUTER SYSTEMS GROUP 4 . | 61000 RJEZ780 


SANTA BARBARA PLANT —  PeS. 2219 0391 REV C 


. 


“Timer évent 3-1 


TRANSMIT/RECEIVE 3-7. 


TRANSPARENT Option (set/reset) 574 
TWO STATIONS DEFINED ON ONE LINE 2-2 


USER AIDS 6-1 
USER COMMANDS 4-1 
USER OPTIONS 5-1 


